Execution Configuration Variables

There are two kind of execution configuration variables - custom execution configuration variables and predefined execution configuration variables.

The autocompletion feature (shortcut Ctrl+Space) is available at all places where you can use an execution configuration variable.

Custom execution configuration variables

To create or edit custom execution configuration variables, click Edit the variables available for execution in the Execution Configuration dialog. They can be used, in assesslets, see Test Assessment - Assesslets, to restrict the execution of an assesslet, for example, or in the Condition text field of the Test Set definition dialog, see Test Sets based on Variables.

By default, these variables are not displayed in the report. To display them, select the Show in Report checkbox. The variables will then be displayed in the Platform Information table of the report.

Configure custom execution configuration variables

Predefined execution configuration variables

The predefined execution configuration variables get their value when the test is executed. So if you use a variable like tpt.date or tpt.time in a directory, you can prevent overwriting existing test data unintentionally.

Variable name Format Description
tpt.testdatadir dir directory in which the data collected at compilation, runtime, assessment, and reporting tests is stored
tpt.tptfile file file name (complete path) of the current TPT file
tpt.tptfile.dir dir directory containing the current TPT file
tpt.tptfile.name text TPT file name (without extension and path)
tpt.execconfigname text current execution configuration name

the characters "ä", "ö", "ü" and special characters are kept, for example, Überlauf (23%)
tpt.execconfigname.filename text file name of the current execution configuration
  • "ä", "ö", "ü" are replaced by "ae", "oe", "ue"
  • "Ä", "Ö", "Ü" are replaced by "Ae", "Oe", "Ue"
  • "ß" is replaced by "ss"
  • other special characters are replaced by "_", for example, Überlauf (23%) becomes Ueberlauf_23_
Default for data storage directory when creating a new execution configuration via the TPT user interface. The maximum number of characters is limited to 32.

tpt.platformconfigname.filename

text

filename of the current platform configuration

  • "ä", "ö", "ü" are replaced by "ae", "oe", "ue"
  • "Ä", "Ö", "Ü" are replaced by "Ae", "Oe", "Ue"
  • "ß" is replaced by "ss"
  • other special characters are replaced by "_", for example Überlauf (23%) becomes Ueberlauf_23_

The maximum number of characters is limited to 32.

tpt.date

text

current date in format YYMMDD

tpt.testreportdir

dir

path to the test report

tpt.time

text

current time in format HHMMSS

tpt.rootdir

dir

installation path of TPT

tpt.version

text

currently used TPT version

For example, you can use the tpt.date and tpt.tptfile.name variables to create a custom directory name.

Variables used in the Execution Configuration dialog

Places where predefined execution configuration variables can be used
  Execution configuration
Variables Data dir Reference dir Report dir Attributes
tpt.version ✓ ✓ ✓ ✓
tpt.rootdir ✓ ✓ ✓ ✓
tpt.tptfile ✓ ✓ ✓ ✓
tpt.tptfile.dir ✓ ✓ ✓ ✓
tpt.testdatadir   ✓ ✓ ✓
tpt.date ✓ ✓ ✓ ✓
tpt.time ✓ ✓ ✓ ✓
tpt.testreportdir ✓   ✓